home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3c / setlabel.z / setlabel
Encoding:
Text File  |  1998-10-20  |  3.1 KB  |  67 lines
  1.  
  2.  
  3.  
  4. sssseeeettttllllaaaabbbbeeeellll((((3333CCCC))))                                                      sssseeeettttllllaaaabbbbeeeellll((((3333CCCC))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _ssss_eeee_tttt_llll_aaaa_bbbb_eeee_llll - define the label for _pppp_ffff_mmmm_tttt and _llll_ffff_mmmm_tttt.
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_pppp_ffff_mmmm_tttt_...._hhhh_>>>>
  13.  
  14.      _iiii_nnnn_tttt _ssss_eeee_tttt_llll_aaaa_bbbb_eeee_llll_((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_l_a_b_e_l_))))_;;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      The routine _ssss_eeee_tttt_llll_aaaa_bbbb_eeee_llll defines the label for messages produced in standard
  18.      format by subsequent calls to _llll_ffff_mmmm_tttt, _vvvv_llll_ffff_mmmm_tttt, _pppp_ffff_mmmm_tttt, and _vvvv_pppp_ffff_mmmm_tttt.
  19.  
  20.      _l_a_b_e_l is a character string no more than 25 characters in length.
  21.  
  22.      No label is defined before _ssss_eeee_tttt_llll_aaaa_bbbb_eeee_llll is called.  A null pointer or an
  23.      empty string passed as argument will reset the definition of the label.
  24.  
  25. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  26.      The following code (without previous call to _ssss_eeee_tttt_llll_aaaa_bbbb_eeee_llll):
  27.  
  28.           pfmt(stderr, MM_ERROR, "test:2:Cannot open file\n");
  29.           setlabel("UX:test");
  30.           pfmt(stderr, MM_ERROR, "test:2:Cannot open file\n");
  31.  
  32.      will produce the following output:
  33.           ERROR: Cannot open file
  34.           UX:test: ERROR: Cannot open file
  35.  
  36. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  37.      _gggg_eeee_tttt_oooo_pppp_tttt(3C), _llll_ffff_mmmm_tttt(3C), _pppp_ffff_mmmm_tttt(3C)
  38.  
  39. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  40.      _ssss_eeee_tttt_llll_aaaa_bbbb_eeee_llll returns 0 in case of success, non-zero otherwise.
  41.  
  42. NNNNOOOOTTTTEEEESSSS
  43.      The label should be set once at the beginning of a utility and remain
  44.      constant.
  45.  
  46.      _gggg_eeee_tttt_oooo_pppp_tttt(3C) has been modified to report errors using the standard message
  47.      format.  If _ssss_eeee_tttt_llll_aaaa_bbbb_eeee_llll is called before _gggg_eeee_tttt_oooo_pppp_tttt, _gggg_eeee_tttt_oooo_pppp_tttt will use that label.
  48.      Otherwise, _gggg_eeee_tttt_oooo_pppp_tttt will use the name of the utility.
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.